home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload Trio 2 / Shareware Overload Trio Volume 2 (Chestnut CD-ROM).ISO / dir31 / ttdoc152.zip / CHAPT5.DOC < prev    next >
Text File  |  1992-12-18  |  8KB  |  145 lines

  1. CHAPTER 5: SAVING AND LOADING CONFIGURATION LIBRARIES
  2.  
  3. As you already know, Tinytalk can hold up to 30 configurations in memory. 
  4. Once you've gotten some configurations set up, you clearly don't want to
  5. repeat the process every time you run Tinytalk.  Therefore, you can save
  6. your configurations to a "configuration library" file on disk (this can be
  7. either your hard drive or a floppy disk), and re-load them the next time
  8. you use Tinytalk.  We call them "configuration libraries" rather than
  9. "configuration files" because each file can hold up to 30 separate
  10. configurations (some other screen readers have one file for each
  11. configuration).  You can also create a "cloned" copy of the Tinytalk
  12. program that has your favorite configurations "burned into" it; since
  13. Tinytalk is so small, you can keep multiple copies configured for various
  14. applications.  
  15.  
  16. In order to move configuration libraries between Tinytalk and your disk,
  17. you need to use the TTCONF utility program that comes with Tinytalk. 
  18. TTCONF is a separate program; you need to be at the DOS prompt in order to
  19. run it.  Even though TTCONF is a separate program, it needs to have
  20. Tinytalk running (in application mode) when you use it.
  21.  
  22.                  SECTION 1: SAVING CONFIGURATION LIBRARIES
  23.  
  24. To save your current configurations to a library file, type "ttconf save "
  25. followed by a file name (if you don't give the filename an extension,
  26. TTCONF will automatically add ".TTK").  For example, if you wanted to save
  27. your configurations in a library file called MYPROGS.TTK, you'd type
  28. "ttconf save myprogs."
  29.  
  30. You can give a library file any name you want (as long as its a legal DOS
  31. filename).  There's no relation between the library file's name and the
  32. names of any of the configurations inside it.  When Tinytalk automatically
  33. selects a configuration based on the program you run, it looks for the
  34. appropriate name among the configurations you have in memory; it doesn't
  35. look for files on disk.  By holding multiple configurations in memory,
  36. Tinytalk avoids having to make disk accesses while running, which greatly
  37. simplifies many of its internal details (for example, it never has to worry
  38. about DOS not being "ready").
  39.  
  40.                 SECTION 2: LOADING CONFIGURATION LIBRARIES
  41.  
  42. To load a configuration library from disk, type "ttconf load " followed by
  43. the file name.  For example, you could recall the configurations you saved
  44. before by typing "ttconf load myprogs." You can tell TTCONF to select a
  45. configuration within the library (if you don't, Tinytalk will switch to
  46. whatever configuration was active when the library was saved).  You do this
  47. by putting the name or number of the configuration after the library file
  48. name.  For example "ttconf load myprogs 5" would bring in the MYPROGS
  49. library and switch to configuration 5.
  50.  
  51. If you load a configuration library that was created for a different
  52. synthesizer than the one you're using, your synthesizer settings will not
  53. change (since the new settings might not be valid for your synthesizer). 
  54. All other configuration settings will change as usual.
  55.  
  56.                         SECTION 3: CLONING TINYTALK
  57.  
  58. To make a custom copy of Tinytalk, type TTCONF CLONE followed by a filename
  59. with no extension (".exe" will be automatically added to the end).  For
  60. example, if you wanted to create a custom version of Tinytalk called
  61. MYTALK, you'd type TTCONF CLONE MYTALK.  From then on, you could run MYTALK
  62. rather than TTALK and you'd come up with the configurations you wanted.
  63.  
  64. Cloning also customizes your copy for the port you selected.  This feature
  65. is not available with the "load" or "save" options, as it makes no sense to
  66. switch ports while Tinytalk is already running.
  67.  
  68. TTCONF looks for a file called TTALK.EXE to use as the basis for the cloned
  69. copy.  If you want to use another file, type its name as a second argument
  70. on the command line.  For example, TTCONF CLONE MYTALK TTECHO would make a
  71. clone of TTECHO.EXE.  If you plan to clone Tinytalk, don't use a
  72. compression utility like LZEXE or PKLITE on the file you're cloning.  The
  73. cloning process requires TTALK.EXE (or the file you specify) to be
  74. available in uncompressed form and findable on the DOS path.
  75.  
  76. If you run Tinytalk or a clone while Tinytalk is already in memory, the
  77. configuration information will be copied over to the version running in
  78. memory.  You won't wind up with two copies in memory (running a clone with
  79. a different port selected won't change your port assignment).
  80.  
  81.                  SECTION 4: THE TTALK ENVIRONMENT VARIABLE
  82.  
  83. (If you're not real comfortable with DOS yet, you can skip this section.) 
  84. You can set an environment variable called TTALK to tell TTCONF where to
  85. look for configuration libraries.  For example, if you wanted to keep all
  86. your configuration libraries in a directory called C:\CONFIG, you could put
  87. the line SET TTALK=C:\TTALK\ in your AUTOEXEC.BAT file.   This will make
  88. TTCONF look in that directory if you don't include a directory name in the
  89. file name.
  90.  
  91.                      SECTION 5: VIEWING CONFIGURATIONS
  92.  
  93. You can also use TTCONF to find out how one or more configurations are set
  94. up.  Typing "ttconf view" will give you a summary of how all your
  95. configurations, global hotkey settings and global key labels are set up. 
  96. If you want to know how the configurations in a library file are set up,
  97. type "ttconf view" followed by the library file name, for example "ttconf
  98. view myprogs." You can tell TTCONF to show only the settings for a single
  99. configuration by following the command with a number sign followed (no
  100. space) by the name or number of the configuration you're interested in, for
  101. example "ttconf view #wp" or "ttconf view myprogs #wp."
  102.  
  103. TTCONF uses DOS output, so you can redirect the display to a file or
  104. printer if you want to, using the standard DOS ">filename" convention.  It
  105. will omit the "more" prompts between configurations if you redirect the
  106. output.  For example "ttconf view >conflist" would create a text file
  107. called "conflist" that would show your settings.
  108.  
  109. If you're viewing all your configurations, TTCONF will also tell you your
  110. port number and your current configuration.  If you're using a synthesizer
  111. like the Doubletalk that doesn't use a serial or parallel port, the port
  112. number listed will be meaningless; it does not mean that the port is
  113. actually tied up.
  114.  
  115. If you run TTCONF without any command-line arguments, it will give you a 
  116. menu of options, and will prompt you for filenames as required.
  117.  
  118. SECTION 6: CONVERTING CONFIGURATION LIBRARIES
  119.  
  120. When we add new features to Tinytalk, we sometimes have to change the
  121. internal format of configuration files.  Unlike some screen-reader
  122. manufacturers who will go unnamed here, we don't believe that re-entering
  123. all your configurations when the file format changes is a productive use of
  124. your time.  Therefore, we supply a program called CVTCONF when we send
  125. upgrades to registered users (if you've been using Tinytalk long enough to
  126. have created a bunch of configurations and to have crossed a version
  127. boundary, you've been using it long enough that you should register!). 
  128. CVTCONF will take a configuration library created under a previous version
  129. and convert it to the format required by the new version.  The version
  130. history in the READ.ME file will tell you whether or not a new version
  131. requires conversion.
  132.  
  133. To convert a library file, type "cvtconf" followed by the file name, for
  134. example, "cvtconf myprogs." Tinytalk has to be running for CVTCONF to work
  135. because it needs to be able to find out some things like what synthesizer
  136. you're using.  If you type "cvtconf" with no arguments, it will convert any
  137. .TTK files it can find.  CVTCONF will make a backup copy of each library
  138. file that it converts.
  139.  
  140. CVTCONF can convert only configuration library files, not cloned copies of
  141. Tinytalk.  If you want to convert a cloned copy, load it, use TTCONF SAVE
  142. to create a library file, convert the library file, uninstall the old copy,
  143. load the new version of Tinytalk, use TTCONF LOAD to bring in the converted
  144. library file, and then clone a new copy.
  145.